主题
授权管理模块总览 - Overview
本分类做什么
对接 欧拉授权平台：在脚本或宿主程序中完成授权登录、激活、试用申请、解绑、公告读取与更新状态查询。
当前包含 9 个接口，以及统一错误码说明：
- 客户端错误码说明 - ClientErrorCodes
- 登录 - Login
- 激活 - Activate
- 申请试用 - Trial
- 解绑 - UnBind
- 强制解绑 - ForceUnBind
- 获取未读公告 - GetUnreadAnnouncements
- 按类型获取公告 - GetAnnouncementsByType
- 获取软件更新状态 - GetSoftUpdateStatus
- 获取软件更新日志 - GetSoftUpdateLogs
一、核心接口职责对照
| 接口 | 典型目的 |
|---|---|
| 登录 - Login | 建立授权会话并获取当前授权状态。 |
| 激活 - Activate | 使用激活码进行授权激活。 |
| 申请试用 - Trial | 无激活码时向平台申请试用授权。 |
| 解绑 - UnBind | 在当前已授权设备上解绑，返回激活码。 |
| 强制解绑 - ForceUnBind | 换机场景：凭激活码解绑旧设备（不要求当前设备已有授权）。 |
| 获取未读公告 - GetUnreadAnnouncements | 获取客户端未读公告列表。 |
| 按类型获取公告 - GetAnnouncementsByType | 按公告类型查询公告。 |
| 获取软件更新状态 - GetSoftUpdateStatus | 查询是否有新版本及更新包信息（仅查询；执行更新见 软件自更新）。 |
| 获取软件更新日志 - GetSoftUpdateLogs | 分页获取正式版已发布版本的历史更新说明。 |
二、推荐使用流程
集成时建议 先尝试登录，未授权再引导用户购买/激活，激活成功后再登录一次建立会话。
下面给出 流程表 + 矢量图；文档站点（VuePress）默认不渲染 Mermaid，请以下方 SVG 为准。
流程一览（表格）
| 顺序 | 环节 | 分支 |
|---|---|---|
| 1 | 调用 Login | — |
| 2 | 判断 Status == 1 | 是 → 进入业务；否 → 下一步 |
| 3 | 提示用户购买激活码或申请试用 | — |
| 4 | Activate（有码）或 Trial（试用） | — |
| 5 | 判断 Status == 1 | 是 → 再次 Login；否 → 展示 Message |
| 6 | 再次 Login | 成功 → 业务；失败 → 展示 Message |
| 7 | 可选：未读公告、软件更新状态等 | 登录成功后 |
矢量流程图（SVG）
步骤说明
| 步骤 | 接口 | 说明 |
|---|---|---|
| 1 | 登录 - Login | 程序启动后 首先调用。成功时 Status 为 1，并返回到期时间、授权类型等；登录成功会自动注册插件，无需再调 Reg。 |
| 2 | 用户提示 | 若 Login 失败（返回 0，或 JSON 中 Status 不为 1），向用户说明 需要购买授权或输入激活码；可展示 Message 中的平台提示。 |
| 3 | 激活 - Activate 或 申请试用 - Trial | 用户输入激活码后调用 Activate；若无激活码且软件支持试用，可调用 Trial（无需激活码）。二者返回结构相同，以 Status = 1 表示授权写入成功。 |
| 4 | 再次 Login | 激活/试用成功后 必须再次调用 Login，才能建立授权会话并（按需）注册插件功能。 |
| 5 | 辅助接口（可选） | 登录成功后，可按需调用 获取未读公告、获取软件更新状态、获取软件更新日志 等。若需执行下载安装，见 软件自更新。 |
判断成功与失败
- Login：接口返回非
0的 JSON 指针，且解析后Status == 1表示登录成功；Status == 0表示失败，应查看Message（多为错误码:中文描述，如2001:未激活，也可直接展示）。未激活时引导走激活/试用流程。 - Activate / Trial：
Status == 1表示平台侧授权已生效，随后再 Login；Status == 0时查看Message（同样为错误码:中文描述，如2003:参数无效、2014:永久卡无法续费、2099:试用已结束，请购买/激活）。 - 错误码：业务失败时
Message多为错误码:中文描述（2000 段）；协议层失败可能返回明文{"errorCode":100x}。完整对照表见 客户端错误码说明。 - 所有返回 JSON 的字符串指针需用 FreeStringPtr 释放。
典型场景
| 场景 | 建议流程 |
|---|---|
| 已购买激活码的新用户 | Login 失败 → 提示输入激活码 → Activate → Login |
| 支持试用的新用户 | Login 失败 → Trial → Login |
| 已有授权的老用户 | 直接 Login 成功 → 进入业务 |
| 换机 / 迁移 | 新设备无授权时：强制解绑 - ForceUnBind 凭激活码解绑旧设备 → 在新设备 Activate → Login。若当前设备已有授权，仍可使用 UnBind |
说明：若业务上确定用户从未授权，也可先
Trial/Activate再Login；但 以先 Login、失败再激活、成功后再 Login 为主流程，可避免已授权用户重复激活，并统一错误处理逻辑。
三、与其它模块的关系
| 模块 | 关系 |
|---|---|
| 设置 - GetMachineCode | 激活常依赖 机器码 或硬件指纹，需与平台侧配置一致。 |
四、错误码速查
失败时请优先阅读 客户端错误码说明 - ClientErrorCodes。常用码：
| Message 示例 | 含义 | 典型处理 |
|---|---|---|
2001:未激活 | 未激活 | 引导 Activate / Trial 后再次 Login |
2005:软件不可用或未开通 | 软件不可用或未开通 | 检查 SoftCode、开通状态 |
2008:授权无效 | 授权无效 | 重新激活或联系客服 |
2009:余额不足 | 余额不足 | 提示充值 |
2012:特性不被允许 | FeatureList 特性不在白名单 | 检查插件特性配置 |
2013:未开放客户端解绑 | 未开放客户端解绑 | 后台开启「开放客户端解绑」或联系发布者 |
2014:永久卡无法续费 | 永久卡无法续费 | 无需再次激活 |
2018:权限不合法，请检查FeatureList参数 | FeatureList 不合法 | 检查 FeatureList 中的插件名与版本 |
五、使用注意
- 参数、返回码、是否需 重复登录/刷新令牌 以 各接口详情页及当前插件版本 为准。
- 正式环境请 关闭调试输出，避免泄露账号、卡密与返回 JSON。